home *** CD-ROM | disk | FTP | other *** search
/ Acorn RISC PD-CD 1 / Acorn RISC PD-CD 1.iso / raytracers / _dkbtrace / dkb / _readme1st next >
Encoding:
Text File  |  1991-08-30  |  2.3 KB  |  63 lines
  1. >!ReadMe1st
  2.  
  3. General
  4. -------
  5. This raytracer was ported to the Archimedes by John Kortink on 31 Aug 1991.
  6.  
  7. It was compiled with Acorn C release 3, with very little effort (only a new
  8. makefile, adapted config.c/h files, and some minor changes to dkbproto.h). A
  9. large part of the credit for this should go to the author(s), who made this
  10. program so excellently portable.
  11.  
  12. It is a very straightforward port, with no fancy additions. I have implemented
  13. simple display routines which use the current mode and ColourTrans to translate
  14. RGB values to colours.
  15.  
  16. Modules that should be present before running dkbtrace are :
  17. - the Shared C Library
  18. - the Floating Point Emulator
  19. - ColourTrans
  20.  
  21. This port behaves almost exactly like the IBM port. Refer to the manual in
  22. docs.DKB212 for further details.
  23.  
  24. Example input files are in examples.dat, but read on, as some filename juggling
  25. is needed to make things work.
  26.  
  27. Filename hassle
  28. ---------------
  29. There are file naming problems : A file of the form <pre>.<post>, e.g.
  30. TRACE.DEF, should appear as the file <post> in the directory <pre>, e.g. 'DEF'
  31. in a directory called 'TRACE', else it will not be found. I have already done
  32. this for the 'hard-wired' files Trace.def, Colors.dat, Shapes.dat and
  33. Textures.dat (the latter three are #included by a lot of example input files).
  34.  
  35. Some example input files also use various other files, e.g. <file>.iff or gif,
  36. as image texture maps. I have put all of these in <post>.<pre> to make things a
  37. bit neater, but when they should be used, they should be put in the main
  38. directory as <pre>.<post>.
  39.  
  40. Fortunately, for input and output files specified by the -i and -o switches, no
  41. extensions are assumed or necessary, though the default output file is DATA.TGA
  42. (for the default Targa output filetype), i.e. when -o is unspecified, a
  43. directory 'DATA' should exist, in which you will find 'TGA' after tracing.
  44. Needless to say that it is strongly recommended to always fully specify input
  45. *and* output filenames, without extensions. This will work OK.
  46.  
  47. The end
  48. -------
  49. If there are any problems, or any other comments you wish to make, contact me
  50. by snail mail :
  51.  
  52. John Kortink
  53. Middelhuisstr. 17
  54. 7482 EL Haaksbergen
  55. The Netherlands
  56.  
  57. netmail : kortink@cs.utwente.nl (until december 1991)
  58.  
  59. bbs : Acorn BBS (Netherlands)-05427-13062, or Huco BBS (Idem)-01804-30785
  60.  
  61. Happy raytracing !
  62.  
  63.